home *** CD-ROM | disk | FTP | other *** search
/ Amiga Plus Special 23 / AMIGAplus Sonderheft 23 (2000)(Falke)(DE)[!].iso / Updates / Datatypes / ilbmdt44 / ilbmdt44.doc < prev   
Text File  |  1999-11-12  |  8KB  |  179 lines
  1.            ilbm.datatype v44
  2.     © 1997-1999 by Stephan Rupprecht
  3.         All rights reserved.
  4.     
  5.  
  6. COPYRIGHT AND DISCLAIMER
  7.  ilbm.datatype v44 is copyrighted 1997-99 by Stephan Rupprecht. 
  8.  All rights reserved. This program is freeware, so no financial
  9.  donations required. Redistribution allowed if the package is 
  10.  left unchanged. The author is not responsible for any damage 
  11.  caused by the use or misuse of this documentation and/or the 
  12.  program(s) it describes.
  13.  
  14.  PlanarToChunky routine © by Morten Eriksen.
  15.  
  16.  All mentioned trademarks are subject to their respective owners.
  17.  
  18.  
  19. REQUIREMENTS
  20.  - Any Amiga® (compatible) computer with at least OS3.0.
  21.  - 68020+ cpu
  22.  - any picture.datatype (v43 recommend, p96 version works 
  23.    without gfxboard)
  24.  
  25.  
  26. DESCRIPTION
  27.  ilbm.datatype v44 is a replacement for the original ilbmdt and allows
  28.  you to display ham and ehb pictures on a non-native (eg. p96/cgfx)
  29.  screen in correct colors. Even if you don't have a gfx-board you'll
  30.  be able to view 24bit iff images and ham8 images on ocs/ecs.
  31.  NOTE: Although this datatype has the version number 44, it is not the
  32.  one that comes with os3.5!
  33.  
  34.  
  35. INSTALLATION
  36.  Just 'Copy ilbm.datatype TO SYS:classes/datatypes/'.
  37.  
  38.  
  39. USAGE
  40.  There's no difference in using my ilbmdt and the original one. The
  41.  datatype automatically adapts itself to the underlying picture datatype.
  42.  You can configure the datatype by placing desired options in an environment
  43.  variable called 'datatypes/ilbmdt44.prefs'. Please use SetEnv (global)
  44.  or Set (local) to create the variable. To make the changes permanent, you
  45.  have to copy the variable from env to envarc.
  46.  
  47.  The preferences template is:
  48.  V42MODE/S,OLDDEC/T,CHIPBM/T
  49.  
  50.  V42MODE: switches the decoder into the v42 compatible mode even when 
  51.  pictdt v43 is installed. You should switch on this option if you don't have
  52.  a gfx-board but pictdt v43 installed.
  53.  
  54.  OLDDEC: Fixes the "corrupt image problem" when using ibrowse in conjuction
  55.  with the p96 pictdt (a few people have the same problem with the cgfx version
  56.  but I can't confirm it). This option switches the datatype into V42MODE for
  57.  images with <= 8bits (behaviour of v44.13 and earlier). Starting version 
  58.  43.40 of picture.datatype (p96) this problem is fixed. To gain maximum speed
  59.  OLDDEC should be turned on as it avoids some redundant planar<->chunky
  60.  conversion for images with 1..7 planes. Default for this option is YES. Use
  61.  OLDDEC=NO to switch it off.
  62.  
  63.  CHIPBM: Tells the datatype to allocate temporary bitmaps in chipmem instead 
  64.  of fastram. If you don't have a patch such as NewWPA8 installed (replaces
  65.  WritePixelArray8 of graphics.library by a faster one), setting this
  66.  option will avoid that garbage is produced when 24bit images are converted
  67.  to ham (also true for ham8 to ham6 conversion). There's no other reason to
  68.  switch on this option as it would slow down the conversion routines. This
  69.  option always changes the global setting! Starting 44.18 this option is
  70.  turned off by default when cgfx or p96 is installed, when there's no cgfx
  71.  (compatible) api available this option is turned on by default. NOTE: Also
  72.  starting 44.18 this option expects either a YES or NO!
  73.  
  74.  
  75. KNOWN PROBLEMS
  76.  - DOpus Mangellan and 24bit/ham images
  77.  According to the docs of DOpus 5.65, DOpus has some problems to
  78.  display 24bit images under certain circumstances. This is not a bug
  79.  of the datatype! (thanks to Dennis Barret for the error report)
  80.  pre 5.65 releases work fine.
  81.  - picture.datatype <= v42 (V42MODE) and 24bit images
  82.  If you get garbage instead of a 24bit image that was converted to ham,
  83.  you can either switch on the CHIPBM option of the datatype or install
  84.  a WritePixelArray8 patch such as NewWPA8 (faster solution).
  85.  - ilbmdt 44.14+, ibrowse and p96 pictdt <= v43.39
  86.  For unknown reasons the navigation buttons of ibrowse are corrupt when
  87.  using it in conjunction with the p96 pictdt. The OLDDEC option worksaround
  88.  this problem by switching the datatype into V42MODE for <= 8bit images.
  89.  
  90.  
  91. HISTORY
  92.  44.0 1st upload: first public release
  93.  44.1 a few optimiziations, skips masking planes now,
  94.        added KNOWN PROBLEMS section to the doc 
  95.  44.2 fixed a bug which made some programs (ex. MUI)
  96.       to display garbage when using a 24bit/ham image on
  97.       a screen deeper than 8bit.
  98.  44.3 bug fix: enforcer hit when library was expunged
  99.      (thanks to Magnus Holmgren for the error report)
  100.  44.4 bug fix: iff24 images with masking weren't correctly
  101.       decoded (thanks to Steve Cutting for the error report)
  102.  44.5 cleaned-up the code a little bit, special version which
  103.       supports planar to chunky hardware
  104.  44.6 removed p2c version (slower than normal one). supports 
  105.       b/w and greyscale pictures now (no cmap, mainly used by 
  106.       PageStream). Didn't set transparent color for images
  107.       with transparent masking (hope that is fixed now).
  108.  44.7 doesn't require cgfx/p96 and pictdtv43 any longer
  109.  44.8 aspect ratio wasn't set 
  110.  44.9 works with ProBench now
  111.  44.10 compiled with gcc (made some internal changes necessary),
  112.        datatype is now some bytes smaller and probably a bit faster
  113.        when decoding <= 8bit images.
  114.  44.11 broke decoding routine for images with masking last time.
  115.        Thanks to Jens Rosenboom for the bugreport.
  116.  44.12 broke something again :( This time the library function
  117.        table. Stupid me! Thanks to Gerald Schnabel for the bug
  118.        report.
  119.  44.13 by request of a single user, you can turn off the HAM to 24bit
  120.        conversion by setting an enviroment variable.
  121.  44.14 changed home directory of prefs variable. 24bit images will be
  122.        converted to HAM when pictdt v43 isn't available (or when V42MODE
  123.        switch is on). enhanced decoder to work in mode v43 even for <= 8bit
  124.        images (which also fixes the "transparent color problem"). 
  125.        added ham8 to ham6 conversion for ocs/ecs machines. supports NAME, 
  126.        ANNO, Copyright, AUTH and FVER chunks, now. optimized and bugfixed
  127.        library module.
  128.  44.15 fixed a harmless (?) bug in the iff scan routine. color palette for ham8
  129.        to ham6 conversion wasn't set up correctly due to a compiler bug. added
  130.        a new switch (CHIPBM) which tells the datatype to allocated temporary
  131.        bitmaps in chipmem instead of fastram (see docs/usage for more about it).
  132.        added OLDDEC option to workaround the "p96 pictdt / ibrowse" problem.
  133.  44.16 improved planar to chunky routine a bit. removed WriteChunkyPixels()
  134.        support for v40+ systems (slower than WritePixeLine8() without c2p
  135.        hardware) <Olaf Barthel>. v43.40 of picture.datatype (p96) fixes the
  136.        corrupt image problem, added a note concerning this to the doc.
  137.        OLDDEC option is now a (/T) toggle and turned on by default.
  138.  44.17 wrong displaymode for ehb pictures were chosen on rtg systems <Ulrich
  139.        Falke>.
  140.  44.18 CHIPBM option is a toggle (/T) now and turned on by default when 
  141.        there's no cgfx (compatible) api available. recompiled using egcs 1.1.
  142.  44.19 accidently removed a line of code in an earlier release, a ham modeid
  143.        was returned in v43mode although the datatype converted the ham source
  144.        to truecolor. in v42mode the colorpalette for truecolor images converted
  145.        to ham wasn't setup correctly <Stephen Brookes>.
  146.  44.20 fixed very bad bug in LibExpunge code (references to freed memory), this
  147.        bug possibly never caused any problems because of the Forbid() state of
  148.        LibExpunge <Thomas Richter>.
  149.  
  150.  
  151. SPECIAL THANKS GO TO ...
  152.  Matthias Scheler and
  153.  Frank Mariak for answering my questions concerning iff-ilbm
  154.  and CyberGFX.
  155.  Volker Remuss for his suggestions.
  156.  Allan Odgaard for the bug report.
  157.  Jens Rosenboom for his bug reports.
  158.  Gunther Nikl for his help with gcc and CreateHAMLine.c.
  159.  Michael Hendren, Alexander Niven-Jenkins, Trevor Daley,
  160.  Constantinos Nicolakakis and many, many other guys for reporting the
  161.  "p96 pictdt / ibrowse problem".
  162.  Olaf Barthel for his help.
  163.  
  164.  And to all other people who send me emails.
  165.  
  166.  
  167. AUTHOR
  168.  
  169.  Please send bug reports and ideas to:
  170.  
  171.     Stephan Rupprecht
  172.     Apfeldweg 1
  173.     D44359 Dortmund
  174.     Germany
  175.  
  176.  Send emails to
  177.  
  178.     stephan.rupprecht@gmx.de
  179.